home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)G / (A)G10.ADF / Util / newzapDOC < prev    next >
Text File  |  1989-03-16  |  4KB  |  76 lines
  1. -------------------------------------------------------
  2. 3]NewZAP
  3. 3]Program and Documentation (c) 1986 Proprietary Products
  4. 3]By John Hodgson
  5. 3]Published in JUMPDISK with Author's Permission
  6. -------------------------------------------------------
  7.                  
  8. 3]WHAT IS NEWZAP?
  9.      NewZAP is a multi-purpose file sector editing utility. If you've ever
  10. had the need to alter just a few bytes within a file, examine its binary and
  11. ASCII representations, or search for key sequences of digits or characters,
  12. NewZAP will make your hacking life a little bit easier. It does what text
  13. editors were not meant to do: precise position-oriented object modifications.
  14. NewZAP will run from CLI or Workbench under 1.1 or 1.2 KickStart with or
  15. without FAST RAM.
  16.  
  17. 3]ORIGINS AND CREDITS
  18.      NewZAP is a third-generation ZAP utility in the sense that it descended
  19. from Apparat's Z-80 based SuperZap to FileZAP (Fred Fish disk # 10) to the
  20. current. NewZAP was compiled under 16-bit Aztec "C", with graphics, fontwork
  21. and debugging assisted by with Deluxe Paint, FontEdit, and MetaScope,
  22. respectively. Thanks to Scott Saunders for the competitive edge, Mike Lehman
  23. for the much-needed documentation, and to R.J. Mical for "A Final Note on
  24. Style".
  25.      Beverages provided by the Coca-Cola Company and Molson Breweries of
  26. Canada, Ltd.
  27.    
  28. 3]USAGE
  29.      The calling sequence from CLI is NewZAP [filename], where filename is
  30. the optional initial file to edit. From Workbench, just click on the gadget.
  31. The rest of the program is... well, self-explanatory! The current file can
  32. be changed at any time by editing the filename string gadget, writing out
  33. any changes to the previous file before switching. Simply click on the HEX
  34. or ASCII windows to reflect the current editing mode. The cursor can be
  35. moved by rolling the mouse with the left button down, or by using the arrow
  36. keys. Note that each window wraps to the next; i.e., you can click on the
  37. HEX window, move the cursor over the the ASCII side, and edit the ASCII
  38. position while still in HEX mode.
  39.      As in FileZAP, you cannot edit past the EOF byte in the last record.
  40. Unlike FileZAP, NewZAP displays and edits full 512-byte sectors via a
  41. 106-character wide internal font. Most commands are duplicated with
  42. matching command sequences; an exception being the HELP key, which brings up
  43. the "About..." menu item. Input/disk errors are flagged with a non-abusive
  44. audible "beep".
  45.      The Search menu is unique to NewZAP. Use it to check for strings or
  46. HEX digits, forward or backward, with or without caps matching. Tired of
  47. batch files that grind your disk drive? Use NewZAP's Search, Edit and Save
  48. functions to modify both instances of ":T" to "T:" in C:EXECUTE. Execute
  49. will henceforth store its preprocessed batch files anywhere you want,
  50. provided you have ASSIGNed T: to some place! I recommend ASSIGNing T: to
  51. RAM: in your Startup-Sequence for ultra-fast EXECUTEs.
  52.  
  53. 3]CAVEATS
  54.      Some folk have requested the ability to extend files. Well, the
  55. original didn't support it, so neither does NewZAP. I've rarely had a need
  56. for this, but perhaps future versions will support it if the demand is
  57. great.
  58.      NewZAP expects an 80-column environment for its titles and gadgets. If
  59. you haven't set Preferences yet, do so!
  60.      NewZAP is a two-edged sword, and can destroy object files with careless
  61. editing. My advice: Work on backup copies.
  62.  
  63. 3]SHAREWARE
  64.      Last, NewZAP is shareware, a concept where authors can release high-
  65. quality software at low cost and risk to users. If you like it, contribute
  66. something to the kitty. If you don't, pass it on. A $15 donation will put
  67. you on the upgrade list, so you can receive the next major revision on disk
  68. via U.S. Postal service. Encourage user-supported software! The author can be
  69. reached at :
  70. Proprietary Products
  71. c/o John Hodgson
  72. P.O. Box 1643
  73. Pebble Beach, CA. 93953-1643
  74.  
  75. 4]END OF TEXT
  76.